  __________________________________
 |                                  |
 |            MiniPaint             |
 |                                  |
 |  Copyright 1988 by Matt Reimer   |
 |                                  |
 |    Published by JEM SOFTWARE     |
 |__________________________________|

 NOTE: MiniPaint requires a 768k IIgs
(At least 640k memory must be free at bootup)


Welcome to MiniPaint
--------------------
MiniPaint is a great new 320 and 640 mode paint program for the IIgs written by
teenage graphics phenom Matt Reimer. MiniPaint offers special features like
scroll bars, movable windows and tremendous flexibility and speed. The name
"MiniPaint" comes from the program's size, not from its feature list! At less
than 85k, MiniPaint gets up and running in a hurry, especially if you're using
Diversified Software Research's Diversi-Cache.

MiniPaint is the first non-AppleWorks enhancement to be published by JEM
Software. Although it's a change in our product line, it fits perfectly with our
philosophy of providing the finest quality software at the lowest prices.

TRIVIA: Developers will be amazed to learn that Matt wrote MiniPaint under APW
with only one 3.5" drive; talk about getting the maximum potential out of your
hardware! We are getting Matt another drive for future projects!


What's Next?
------------
MiniPaint is actually the precursor to a Beagle Bros paint program which will be
released in the (hopefully) near feature. The Beagle version will tentatively
offer multiple documents (four in memory at a time), imports of Print Shop(TM),
single hi-res, double hi-res and Macintosh pictures, a powerful pattern editor,
multi-colored brushes, special effects, etc.

MiniPaint owners will be eligible for a $15 discount on the Beagle version. When
MattPaint, BeaglePaint or whateverPaint is released, send your original
MiniPaint disk and the Beagle price minus $15 to JEM Software for your copy.
Don't forget to add the $2.50 shipping and California sales tax if necessary.


     =====================
---> !!!! Art Contest !!!! <---
     =====================

The official JEM Software MiniPaint Artist Search is now underway! Send us some
pictures that you create with MiniPaint. The artists submitting the best three
pictures (as selected by Randy and Matt) will receive free copies of the Beagle
paint program (see previous paragraph). The very best picture will also be
rewarded with a non-rubberized check for $25.

Rules:

1. The picture(s) must be an original. Anyone caught submitting someone else's
work will have their names stricken from the JEM Software registration list
and will be forever an outcast in our world.
2. The picture(s) must be submitted on 3.5" disk.
3. All pictures submitted may be used freely by JEM Software as sample art.
4. No prizes will be awarded if fewer than 10 reasonable attempts at art are
received. Of course, one artist could submit 10 reasonable attempts.
5. All decisions of the judges are smart and final.
6. Great pictures submitted after the deadline might still be rewarded!


Getting Started
---------------
1. Start your IIGS with the MiniPaint disk in the drive.  MiniPaint will
automatically start up.  If there's not enough memory, it will quit.

NOTE: If you have a large RAM disk, there may not be enough memory for MiniPaint
even on a 1.25 meg IIgs. Use the Control Panel to set your RAM disk to 0k, shut
off your IIgs, and then reboot.

3. Now that you're in MiniPaint, press Open-Apple G to get a picture.
4. Select "Help.Picture" from the MiniPaint disk. This is a handy reference to
the keyboard shortcuts and special commands in MiniPaint.
5. Select page setup from the Edit menu and choose 50% reduction.
6. Print the handiest keyboard reference you'll ever own. It looks great when
printed with a LaserWriter!

GS/OS NOTE:
MiniPaint is compatible with the new GS/OS. Just copy the MINIPAINT.SYS16 file
to a GS/OS disk and boot up with it. Use INSTALLER to add SPECTRUM to your GS/OS
disk.

---------------------------------
READ THIS!!! Some MiniPaint Terms
---------------------------------
The MiniPaint document assumes you understand what a few terms mean. Here are
some of the slightly more esoteric items:

o  OPTION means the key labelled "option"
o  APPLE means the key with an open apple on it; Apple-. means hold down the
open-apple key and press the period key.
o  click means press the mouse button and immediately let it up again
o  double-click means quickly press the mouse button twice
o  keyname-click means hold down the specified key while you press the mouse
button once and then let go. For example, OPTION-click means hold down the
OPTION key while you click the mouse button once
o  dragging means that you hold down the mouse button while moving the mouse

_____________________________________________________________________________

Painting Window
---------------
The Info Bar shows the cursor coordinates, delta coordinates, current
tool,current pen, border, and background color, and the dither lock status.

Depending where the window is on the screen, you may not be able to see all of
the info bar. One way to solve this is by using Whole Screen mode. Or, select
Clean Up from the Window menu, and then turn the scroll bars off.


Setting Colors
--------------
There are several types of color selections which can be set using the
color/pattern palette on the bottom of the MiniPaint screen. The left part of
the palette shows the paint or pen color framed by the border color, which is in
turn framed by the background color. This is also echoed on the info bar. The
shadow color can only be seen by creating a shadowed shape.

Paint/Pen Color
o  click on a color or pattern to set the pen color
o  used by pencil, brush, spray can, fill bucket, solid shapes
o  used by lines if OPTION-click is used to start drawing the line

Border Color
o  Apple-click on a color or pattern to set the border color
o  used by borders, lines

Background Color
o  click on a color, then press OPTION and release the button to set the
background (this will also change your pen color unless you start with the
cursor on the current pen color)
o  used by eraser

Shadow Color
o  CTRL-click on a color to set the shadow color
o  used by shadows when solid shapes are started with CTRL-click


Using the Spare Page
--------------------

The Spare Page is like having two completely different pictures in one window.
You can instantly switch between them by pressing Apple-^.  Use the spare page
for experimentation, and when you're ready to use the image you've created, copy
it into your picture.  You can move pictures to and from the spare page via the
clipboard or the two copy commands in the Windows menu (see "Pic to Spare" and
"Spare to Pic").

Or you can use the spare page to backup your picture.  Copy the picture to the
spare with the "Pic to Spare" command, and if you really mess up the original,
use the "Spare to Pic" command (or Revert, if you've already saved the picture).

However, using the spare page has its drawbacks.  The spare page takes up about
62k of memory, so you may not be able to use it on your system.

NOTE: You can only Save, Save As..., Revert, or Print... the picture page, not
the spare page.

Tips
----
o  For the fastest operation, turn off scroll bars, info bar, coordinates,   and
crosshairs, and don't leave any windows overlapping. Press ESCape while using
most tools to hide the tool.

o  Use the spare page to experiment, and copy it to the original on the other
page when you're done experimenting.

o  If you run low on memory, kill the spare page if you're using one (see
Get/Kill Spare in the Windows menu).  If that doesn't free up enough, copy a
very small area to the clipboard.  This will shrink the clipboard.  If that
doesn't help, save your picture and try restarting.

o  To move the marquee or lasso selection to or from the spare page, make sure
the selection is floating (by moving it) and then press Apple-^.  This works
much faster than using the clipboard.

o  Move the tool, pen size, or color windows by OPTION-clicking inside the
window and then dragging to the desired position.

o  To lighten an image, select the third pattern (not color), and draw a solid
shape over the image using OR mode by holding down the Apple key as you draw.

o  To color a pattern on the picture, first draw the patterned shape. Then
choose the color you want. Draw over the image using OR mode by
Apple-clicking as you draw. You can also use the OR mode to draw a pattern
over a color.

o  CTRL-click on a color to sets the shadow pattern or color

o  Load MPAINT.SAMPLES and try some of its suggestions.

o  Surround some text with the lasso, release the mouse button, move the mouse
until you get an arrow cursor, then press the button followed by Escape. Now
you can drag the text around quite nicely.

o  When starting MiniPaint, hold down the OPTION key until you see the "Please
wait" message and you'll be in 640 mode

o  If you find a bug in MiniPaint, spray Raid all over your keyboard. If that
doesn't solve the problem, take a hammer and smash your monitor. If that
still doesn't solve the problem, write a nice letter to Matt c/o JEM Software
and clearly describe how he might duplicate the problem at home

_____________________________________________________________________________

MINIPAINT REFERENCE SECTION: A MOST USEFUL SOURCE OF VITAL INFORMATION
_____________________________________________________________________________

MiniPaint Menus
---------------
To access a MiniPaint menu, position the cursor on the menu title at the top of
the screen and press the mouse button. The menu will appear, and you can then
select the desired option. Here's a summary of the menu choices:

Apple menu
==========
About MiniPaint...
Shows the current version of MiniPaint, JEM Software's address and the amount of
RAM still happily unemployed within your IIgs's internal economy.

Help...
A couple of tips which you know about already.

Spectrum
This is a new desk accessory by Matt that makes it easy to choose between the
4,096 colors available for your color palette. Read the documentation near the
end of this file.

_____________________________________________________________________________

File menu
=========
New            Keyboard: Apple-N        Mnemonic: New

Use New to start all over (or "anew" if you wish). New closes the current
picture if there is one, and opens a new window with the default patterns and
colors, pen and text modes, font, style and size. The status of the info bar,
scroll bars, coordinates, and crosshairs remain the same. If a spare page is
being used, it is erased.  If a picture is open when New is selected, MiniPaint
asks if you would like to save it before opening the new window.

Open           Keyboard: Apple-G        Mnemonic: Get picture

Use Open to retrieve a picture from disk. Open closes the current picture if
there is one, and opens a new window.

* Note: Hold down the OPTION key while selecting Open to load the picture
without closing the current window. MiniPaint will open the new picture on top
of the current picture.

Close

Use Close when you're done with the picture you're working on. If the picture
has been changed since it was opened, MiniPaint asks if you would like to save
it first.

Save

Use Save to save the picture using the same name that it was opened with. If it
wasn't loaded from a disk, this option is unavailable.

Save As...

Use Save As... to save the picture under a different name.

Revert

Use Revert to restore the picture to the last version you saved. If the picture
wasn't loaded from disk, this option is unavailable.

Choose Printer...

Use Choose Printer... to tell MiniPaint what printer setup you have. If your
printer doesn't work, complain to Apple, not us. We're just using Apple's
printer tools.

Page Setup...

Use Page Setup... to tell MiniPaint how you would like your picture printed. On
the ImageWriter II you can set:

o  Paper size
o  Orientation - sideways or right-side-up
o  50% reduction
o  No gaps between pages. If you are using the full length of the picture, check
this box.
o  Vertical sizing - normal or condensed

Normally you'll want to use US Letter size paper, right-side-up orientation, no
reduction, no gaps between pages, and normal vertical sizing.

Print          Keyboard: Apple-P        Mnemonic: Print

Use Print to print your picture (what else?). If a marquee selection is active,
only the area inside the box will be printed.

Press Apple-. to abort the printing process. Remember that MiniPaint will wait
all day if your printer is on, but not online.

Quit           Keyboard: Apple-Q        Mnemonic: Quit

Use Quit when you're all done with MiniPaint.

_____________________________________________________________________________

Edit Menu
---------

Undo           Keyboard: Apple-Z

Use this to undo the last change you made to your picture. Some changes can't be
undone. It's smart to save copies of pictures before making drastic changes.

Copy           Keyboard: Apple-C

Use this to copy the marquee selection to the clipboard. If the whole picture is
selected, the whole picture is copied to the clipboard.

Cut            Keyboard: Apple-X

Use this to move the marquee selection to the clipboard, erasing it from the
picture. If the whole picture is selected, the whole picture is moved to the
clipboard.

Paste          Keyboard: Apple-V

Use this to paste the clipboard contents into your picture. If there is a
marquee selection, the image is resized to the dimensions of the marquee box. If
the original image was bigger than the box, the image is shrunk. If the original
image was smaller than the box, the image is expanded.

Try this:

Copy or Cut a selection to the clipboard. Now select the window by
double-clicking the marquee icon. Choose Paste from the Edit Menu to resize the
image on the clipboard to the size of the window.

...or this:

Copy or Cut a selection to the clipboard. Now select the entire picture by
triple-clicking the marquee icon. Choose Paste from the Edit Menu. A dialog
comes up asking if you want to do this. Click Ok and the image on the clipboard
is resized to the size of the whole document.

Clear          Keyboard: {delete} or {clear}

Use Clear to clear the marquee selection. If the whole picture is selected,
the whole picture is cleared.

Invert         Keyboard: n              Mnemonic: iNvert

Use Invert to exchange the colors in the marquee selection for their palette
complement. For instance, color 1 becomes color 16, colors 2 becomes color 15,
color 3 becomes color 14, etc. Black becomes white and white becomes black.
Invert again to restore the original colors.

Flip Horiz     Keyboard: x              Mnemonic: x, as in x coordinate

Use this to flip the marquee selection horizontally. The pixels on the left are
exchanged with the pixels on the right. Flip Horiz has the effect of turning the
selection backwards.

Flip Vert      Keyboard: y              Mnemonic: y, as in y coordinate

Use this to flip the marquee selection vertically. The pixels on the bottom are
exchanged with the pixels on the top. Flip Vert has the effect of turning the
selection upside-down.

Rotate
This option is not currently implemented. If it was, it would turn the selection
sideways.

Free Rotate
This option is reserved for the Beagle version of MiniPaint (tentatively titled
MattPaint, or BeaglePaint, or...). Use Rotate to rotate the selection any angle,
from 1 degree to 360 degrees.

Replace Color  Keyboard: >              Mnemonic: color1 > color2

Use this to replace any color within the marquee selection with any other color
on the current palette.

When Replace Color is selected, the cursor changes to the color cursor. Click on
the color you want to change. Then click on the color you want to replace it
with. You may click on the palette or inside of the selection.

_____________________________________________________________________________

Yum menu
--------
This is the "Goodies" menu, but "Yum" is all that fits on the menu bar in 320
mode. It's better than using "Goo", isn't it?

Grid           Keyboard: g              Mnemonic: grid

Use Grid to align objects on a 9 x 9 pixel grid. Grid affects boxes, rounded
boxes, ovals, polygons, and text.

FatBits        Keyboard: Apple-F        Mnemonic: Fatbits

Use FatBits to zoom in on an area of the picture for fine detail work. FatBits
can also be selected by double-clicking the pencil icon. FatBits only works with
the hand and pencil tools. Clicking on another tool turns FatBits off.

To zoom in on a particular part of the picture, hold down the Apple key and
click with the pencil on the area you would like to see.

To turn FatBits off:
o  Select FatBits from the Yum menu
o  Double-click the pencil icon
o  Apple-click with the pencil
o  Click on the top left portion of the window, where the picture is shown
normal size

Note: While using the pencil, hold down the OPTION key to activate the hand tool
and move the picture.

In 320 mode, FatBits expands each pixel to a 6 x 5 pixel block. In 640 mode with
dither lock on, each pixel is expanded to a 16 x 5 pixel block, showing every
two pixels as one dithered color. In 640 mode with dither lock off, each pixel
is expanded to a 8 x 5 pixel block, displayed in its true color.

Dither Lock    Keyboard: Apple-D        Mnemonic: Dither lock

Used for 640 mode only. Use dither lock when you want to draw using dithered
colors. Dither Lock makes MiniPaint draw two pixels wide. When Dither Lock is
turned on and the paint window has an info bar, a padlock icon is shown.

Effects with Dither Lock on:

Lasso: makes the lasso move the image two pixels at a time, maintaining the
proper coloring. Otherwise dithered images would change colors every other pixel
movement.

Bucket: see section on Dithered colors

Lines, hollow and solid shapes: makes lines at least two pixels wide, aligning
the endpoints only on even pixels.

Marquee: aligns the marquee to even pixels, and moves the image two pixels at a
time.

Pencil: makes the pencil two pixels wide, drawing only on even-paired pixels.

Eraser: aligns the eraser to even pixels.

Dither Lock also causes FatBits to display every two pixel-pairs as one dithered
pixel.

Pen Mode...
Use pen mode to change the way the pen draws. Normal is COPY. See the Pen Mode
appendix near the end of this document.

Text Mode...
Use text mode to change the way text is drawn. Normal is foreCOPY. See the Text
Mode appendix near the end of this document.

Shadow...      Keyboard: Apple-@

Use this to adjust how far away the shadow is drawn from the shape.  The
horizontal scroll bar controls the horizontal offset of the shadow, and the
vertical scroll bar controls the vertical offset.  Press ESC to cancel or return
to accept.

Brush Shape... Keyboard: keypad *       Mnemonic: * looks like a brush

Use this to choose the shape the paint brush will draw with. You can also
double-click the brush icon to get this dialog. Click on the brush shape you
want to exit.

You can also press 9 for the previous brush shape and 0 for the next brush shape
in the brush table.

Check "No gaps between brushes" to draw solid lines with the brush. Uncheck "No
gaps" to draw broken lines with the brush. This has the same effect as the spray
can.

Show Page...  Keyboard: keypad =

Use Show Page to show the current picture at a 50% reduction. You can also use
Show Page by pressing keypad = or by double-clicking the hand icon.

A box that is drawn over the reduced picture shows the area in the window. Drag
the box to another part of the picture and click Ok to move to that part of the
picture. Click cancel to stay where you were before selecting Show Page.

640 mode or 320 mode

Use this option to switch to the mode displayed on the menu. If a picture was
created in 640 mode and you switch to 320 mode, the colors are converted to
their 320 mode equivalents. However, if a picture was created in 320 mode and
you switch to 640 mode, the default 640 mode colors are shown instead of the
original colors because of hardware limitations. In either mode, PATTERNS CANNOT
BE CONVERTED so they look like trash. The patterns are not destroyed, but they
merely don't display properly in the wrong mode. Switching back to the original
mode cures that.

Warning!  A picture is saved exactly how it appears on-screen. If you make a
picture in 320 mode and switch to 640 mode and save it, the picture is saved as
a 640 mode picture with the 640 mode palette, and vice versa. Be careful!

Find Color     Keyboard: k              Mnemonic: kolor find

Use find color to locate a particular color in the picture. This is useful with
colors that gradually increase in brightness but look the same.

The cursor is changed to the color cursor and all occurrences of the color under
the cursor start flashing. Move the cursor over the colors you want to find and
click when you're done. This can be hard on the old eyeballs; studies show that
most people who have eye trouble due to using CRT's all day actually use Find
Color several hours per day!

Edit Palette

Not implemented in MiniPaint. See "Spectrum" for the equivalent.

Edit Pattern

Reserved for Beagle version of MiniPaint. Lets you edit color patterns.

Import

Reserved for Beagle version of MattPaint. Lets you import MacPaint, hi-res,
double hi-res, and Print Shop graphics.

_____________________________________________________________________________

Window menu
-----------

Whole Screen   Keyboard: Apple-W        Mnemonic: Whole screen

Zooms the paint window to use the whole screen. Use Apple-W to zoom in and out.
To zoom in completely for the maximum painting area, turn off the info bar and
scroll bars and press Apple-W.

Press OPTION-Apple-W to leave the menu bar on the screen. To unzoom, press
OPTION-Apple-W again.

Hide Tools     Keyboard: Apple-H        Mnemoic: Hide tools

Reserved for MattPaint.

Scroll Bars    Keyboard: s              Mnemonic: scroll bars

Use this to turn the scroll bars on and off.

Info Bar       Keyboard: i              Mnemonic: info bar

Use this to turn the info bar on and off.

Coordinates    Keyboard: c              Mnemonic: coordinates

Use this to turn the coordinate display on and off. Coordinates are only
displayed if the Info Bar is on. This is useful for precision work. For the
fastest operation, leave this off.

Crosshairs     Keyboard: +              Mnemonic: + looks like crosshairs

Use this to turn the crosshairs on and off. This is useful for lining up precise
objects or making a precise marquee selection.

Clean Up

Use this to put all the windows back in their proper place. In MattPaint, this
tiles the four picture windows so they can all be seen at once.

Stack Up

Reserved for MattPaint. Use this to stack up the picture windows.

Get Spare/Kill Spare

Use this to get a spare page or to kill one if you've already got one.  This is
useful when you run out of memory.

Spare Page     Keyboard: Apple-^

Use this to switch between the spare page and the picture.

Pic to Spare   Keyboard: Apple->

Use this to copy the picture to the spare page.

Spare to Pic   Keyboard: Apple-<

Use this to copy the spare page to the picture.

picture name   Keyboard: Apple-1

Use this to make the picture window the current window. If the window is hidden,
it reappears.

In MattPaint, you will be able to have Apple-1 through Apple-4.

_____________________________________________________________________________

Font menu
---------

Fine tune      Keyboard: t              Mnemonic: tune a font

Use this to choose a certain font, size and style. This is useful if you need a
certain size that's not in the Size menu, or if you have too many fonts to be
displayed in the Font menu.

The rest of the menu lists any fonts installed. If the menu overflows, the
remaining fonts can only be accessed through Fine Tune.

_____________________________________________________________________________

Style menu
----------

Plain          Keyboard: Apple-T        Mnemonic: Text, just plain old text

Bold           Keyboard: Apple-B        Mnemonic: Bold

Italic         Keyboard: Apple-I        Mnemonic: Italic

Underlined     Keyboard: Apple-U        Mnemonic: Underlined

Outline        Keyboard: Apple-O        Mnemonic: Outline

Shadow         Keyboard: Apple-S        Mnemonic: Shadow

Use these to stylize the current font.

Align Left     Keyboard: Apple-L        Mnemonic: Left justified text

Use this to type from left to right.

Align Middle   Keyboard: Apple-M        Mnemonic: Middle justified text

Use this to center some text. This is useful for labelling an object. Click
where you want the center of the text to be and type the label.

Align Right    Keyboard: Apple-R        Mnemonic: Right justified text

Use this to right justify the text. This is useful for labelling the left side
of an object. Click where you want the right edge to be and type.

_____________________________________________________________________________

Size menu
---------

8, 10, 12, 14, 18, 24, 36, 48, 72 or ??

Selects the size of the current font. The last size is the weird size, which can
be set by using Fine tune.

_____________________________________________________________________________


MiniPaint Tools
---------------
This section describes each one of MiniPaint's powerful tools. They are pictured
in the icons on the left side of the MiniPaint screen. In the following
reference, the tool name is given first, followed by the keyboard equivalent. A
mnemonic then tells you how to remember the keyboard command. For example, the
first tool is a lasso with a lower-case "l" as the keyboard command. Remember it
as "l" for "lasso".

To use a tool, either press the keyboard equivalent or click inside the icon on
the left of the screen. The icon will be inversed, signifying that it is now
active. The info bar at the top of the screen will also depict the current tool.

Lasso          Keyboard: l              Mnemonic: lasso

Use the lasso to move an irregularly shaped object.

To select an object:

o  Hold down the mouse button and surround the object you want to move. The
smaller the area you surround, the faster it works.

o  When you release the button, MiniPaint collapses the edges around the object
unless you used OPTION-click to start drawing. In that case the lassoed
object will be exactly what you selected.

o  The object is removed from the picture and now "floats" above the picture.

To move an object:

o  Move the cursor inside the object until the cursor changes from the lasso to
the arrow and hold down the button.

o  Drag the shape to its new location and release the button.

Special option:

o  OPTION-click selects an object without collapsing the outer edges

Options available after surrounding the lasso image:

   From the Edit menu:
o  Clear (keyboard {delete} or {clear})
o  Flip horizontal (keyboard x)
o  Flip vertical (keyboard y)
o  Invert (keyboard n)
o  Replace color (keyboard >)

o  OPTION-click to leave a copy behind
o  SHIFT-click to drag on a horizontal or vertical line
o  ESC while dragging hides the cursor and the flashing outline of the shape

_____________________________________________________________________________

Marquee        Keyboard: m              Mnemonic: marquee

Use the marquee to move a rectangular object. Double-click the marquee icon to
select the whole window, and triple-click to select the whole picture.

To select an object:

o  Hold down the button and surround the object you want to move. The smaller
the area you surround, the faster it works.

To move an object:

o  Move the cursor inside the object until the cursor changes from the crosshair
to the arrow and hold down the button.

o  Drag the shape to its new location and release the button.

Note: Before an object is moved, it is still on the canvas. Once it is moved,
however, it floats above the canvas. This is useful when you want to move
something to another part of the picture. Move the marquee selection, making it
float. Then use the scroll bars to move to the other part of the picture.

Options available:

o  Double-clicking the marquee icon selects the whole window
o  Triple-clicking the marquee icon selects the whole document
o  SHIFT-click when starting to surround a square instead of a rectangle

Once you've selected an area and released the mouse button:

   From the Edit menu:
o  Copy (Apple-C)
o  Cut (Apple-X)
o  Paste (Apple-V)
o  Clear (keyboard {delete} or {clear}
o  Flip horizontal (keyboard x)
o  Flip vertical (keyboard y)
o  Invert (keyboard n)
o  Replace color (keyboard >)

o  OPTION-click to leave the original behind when dragging
o  SHIFT-click to drag on a horizontal or vertical line only
o  CTRL while dragging to use OR mode
o  ESC while dragging hides the cursor and the flashing outline of the shape

_____________________________________________________________________________

Hand           Keyboard: h              Mnemonic: hand

Use the hand to move to the window to a different part of the picture.

To move the picture, hold down the button and move the mouse.

Note: When the pencil is selected, the hand may be activated by holding down
OPTION key. When you release OPTION, the pencil returns.

Options available:

o  Double-click the hand icon to use Show Page.

_____________________________________________________________________________


Text           Keyboard: a              Mnemonic: text icon is an "A"

Use the text tool to type on the picture. Double-click the text icon to use Fine
Tune fonts feature.

To use the text tool, click where you want to start typing. Type away. To type a
character not on the keyboard, hold down OPTION and press a key.

o  Return accepts current text and moves to the next line
o  Delete erases the last character typed
o  Clear deletes everything since the last Return
o  Escape deletes everything since the last Return and leaves text entry mode
o  Apple-Return accepts current text and leaves text entry mode (this is handy
when the tools are hidden and you're using keyboard commands)

To change the color of the text, click on a color in the color window. To change
the font, choose a font in the Font menu. To change the style, choose a style in
the Style menu. To change the size, choose a size in the Size menu. Use Fine
Tune in the Font menu to choose different sizes, etc.

Try Align Left, Align Middle, and Align Right in the Style menu. Also try Text
Mode in the Yum menu. It allows your text to act in rather unusual ways.

Note: If Grid is on, text is aligned to the grid.

Options available:

o  Double-click the text icon to use Fine Tune
o  Apple-click to use foreOR mode
o  click in color window to change the font color
o  change modes with Text Mode... in Yum menu
o  Fine tune in the font menu to change font, style and size
o  choose any font in the Font menu to switch fonts
o  change Styles and alignment in the Style menu
o  changes Sizes in the Size menu

_____________________________________________________________________________


Paint Bucket   Keyboard: f              Mnemonic: fill

Use the Paint Bucket to fill any shape with a color or pattern.

To use the Paint Bucket, select the color or pattern you want to fill with. Then
click the button inside the shape you want to fill.

In 640 mode, the bucket will only fill non-dithered colors. If you
accidentally try to fill a dithered color, press ESC. See the information on
dithered colors in Appendix D.

Note: Press the ESC key to abort a fill.

_____________________________________________________________________________

Paint Brush    Keyboard: ,              Mnemonic: , looks like a brush stroke

Use the Paint Brush to apply a color or pattern using one of 32 brush shapes.
Select the tool, then hold down the button and drag the brush.

To change brush shapes, press the keypad *, double-click the brush icon, or
select Choose Brush from the Yum menu. Click on the brush shape you want. If you
would like broken instead of solid lines, uncheck the "No gaps between brushes"
box. This in effect gives you 32 spray can patterns to work with.

Options available while drawing with the brush:

o  Double-click the brush icon to select a different brush
o  SHIFT-click to draw on a horizontal or vertical line only
o  press ESC to hide the cursor
o  press "+" to toggle the crosshairs on/off while drawing

_____________________________________________________________________________

Pencil         Keyboard: .             Mnemonic: . looks like a pixel

Use the pencil to draw free-form. To draw, click the button and drag it around.
If the pencil is clicked on the same color as the pen color, the pencil will
erase, using the background color.

The pencil is especially useful in FatBits (see Fatbits).

Options available:

o Double-click the pencil icon to turn FatBits on
o SHIFT-click to draw on horizontal or vertical lines
o OPTION changes the cursor to the hand to move around the picture
o Apple-click zooms in where the pencil was clicked; Apple-click turns FatBits
off if it's on
o ESC while drawing hides the cursor
o press "+" to toggle the crosshairs on/off while drawing

_____________________________________________________________________________

Lines          Keyboard: /              Mnemonic: / looks like a line

Use this to draw straight lines. Select it, then click the button at one end of
the line and drag the line to where you want it and release the button.

Lines are drawn using the current pen size and border color.

Options available:

o SHIFT-click for horizontal, vertical or diagonal lines
o OPTION-click to draw the line in the pen color instead of the border color
o Apple-click to use OR as the pen mode

_____________________________________________________________________________

Eraser         Keyboard: e              Mnemonic: eraser

Use this to erase an area. To erase, click the button and drag the eraser over
the area you want to obliterate.

The eraser uses the background pattern.

Options available:

o  Double-click the marquee icon to erase the whole window
o  SHIFT-click to erase on horizontal or vertical lines
o  ESC hides the cursor while erasing
o  press "+" to toggle the crosshairs while drawing

_____________________________________________________________________________

Hollow Boxes   Keyboard: shift-b        Mnemonic: Boxes
Hollow Rounded Boxes  Keyboard: shift-r Mnemonic: Rounded boxes
Hollow Ovals   Keyboard: shift-o        Mnemonic: Ovals; O looks like an oval

Use these tools to draw hollow shapes. To draw, click the button at one edge of
the shape and drag it to where you want it and release the button.

Hollow shapes are drawn using the current pen size and border color.

Options available when starting to draw:

o SHIFT-click for square shapes (circular ovals)
o OPTION-click to draw the shape in the pen color instead of the border color
o Apple-click to use OR as the pen mode
o CTRL-click to draw a shadow under the shape

_____________________________________________________________________________

Solid Boxes    Keyboard: b              Mnemonic: boxes
Solid Rounded Boxes  Keyboard: r        Mnemonic: rounded
Solid Ovals    Keyboard: o              Mnemonic: ovals; o looks like an oval

Use these tools to draw solid shapes. To draw, click the button at one edge of
the shape and drag it to where you want it and release the button.

The interiors of solid shapes are drawn using the current pen color and the
borders are drawn using the current pen size and border color. Hold down the
OPTION key to draw the border with the same color as the interior.

Options available when you start drawing:

o SHIFT-click for square shapes (circular ovals)
o OPTION-click to draw the border with the same color as the interior
o Apple-click to use OR as the pen mode
o CTRL-click to draw a shadow under the shape

_____________________________________________________________________________

Hollow Regions Keyboard: shift-q         Mnemonic: curly shapes; q is "qurly"

Use this to draw hollow regions. To draw, click the button and drag the mouse
any which way. When you release the button a line is automatically drawn to the
starting point, completing the shape.

Hollow regions are drawn using the current pen size and border color.

Options available:

o SHIFT-click to draw on horizontal or vertical lines only
o OPTION-click to draw the shape in the pen color instead of the border color
o Apple-click to use OR as the pen mode
o + or keypad + toggles the crosshairs while drawing
o CTRL-click to draw a shadow under the shape

_____________________________________________________________________________

Solid Regions  Keyboard:q               Mnemonic: curly shapes; q is "qurly"

Use this tool to draw solid regions. To draw, click the button and drag the
mouse. When you release the button a line is automatically drawn to the starting
point, closing the shape.

The interior of a solid region is drawn using the current pen color and the
border is drawn using the current pen size and border color. Hold down the
OPTION key to draw the border with the same color as the interior.

Options available:

o SHIFT-click to draw on horizontal or vertical lines only
o OPTION-click to draw the shape in the pen color instead of the border color
o Apple-click to use OR as the pen mode
o + or keypad + toggles the crosshairs while drawing
o CTRL-click to draw a shadow under the shape

_____________________________________________________________________________

Hollow Polygons Keyboard: shift-p       Mnemonic: Polygon

Use this to draw hollow polygons (polygons are a series of connected lines). To
draw, click the button and draw a line. Release the button and draw another
line, clicking again when the new line is positioned. When you want to close the
polygon, click outside the window or double-click inside the window.

Hollow polygons are drawn using the current pen size and border color.

Options available:

o SHIFT-click for horizontal, vertical or diagonal lines
o OPTION-click to draw the line in the pen color instead of the border color
o Apple-click to use OR as the pen mode

_____________________________________________________________________________

Solid Polygons Keyboard: p             Mnemonic: polygon

Use this to draw solid polygons (polygons are a series of connected lines). To
draw, click the button and draw a line. Release the button and draw another
line, clicking again when the new line is positioned. When you want to close the
polygon, click outside the window or double-click inside the window.

The interior of a solid polygon is drawn using the current pen color and the
border is drawn using the current pen size and border color. Hold down the
OPTION key to draw the border with the same color as the interior.

Options available:

o SHIFT-click for horizontal, vertical or diagonal lines
o OPTION-click to draw the line in the pen color instead of the border color
o Apple-click to use OR as the pen mode
o CTRL-click to draw a shadow under the shape
o + or keypad + toggles the crosshairs while drawing

_____________________________________________________________________________

SPECTRUM: A COLORFUL NEW DESK ACCESSORY
_____________________________________________________________________________

Spectrum is a handy new desk accessory (NDA) by you guessed it, boy-wonder Matt
Reimer. (Editor's note: Matt gets embarrassed, but what can he do?) Spectrum
derives its name from its ability to present you with a spectrum of vibrant
colors (at least they're vibrant in 320 mode) to work with.

How to Use Spectrum
-------------------
Choose Spectrum from the Apple menu.

Along the top of the window is the color palette. The color in the top left
corner is color 0, and the color in the bottom right is color 15.

The leftmost scroll bar controls the amount of Red in a color. Click the arrow
on the bottom for more Red, or the one on the top for less Red.

The middle scroll bar controls the amount of Green in a color. Click the arrow
on the bottom for more Green, or the one on the top for less Green.

The right scroll bar controls the amount of blue in a color. Click the arrow on
the bottom for more Blue, or the one on the top for less Blue.

In case it hasn't occurred to you, the color bars are ordered RGB- Red Green
Blue, not Randy G. Brandt.

The colored square to the right of the scroll bars shows the current color. This
is the color that might well get modified.

Directly below the current color box is the Reset button. Click this button to
restore the palette to the colors you started with.

Below the Reset Button is the Undo button. Use this button to undo the changes
you've made to the current color, or to undo the last copy, or to undo the last
Spread. Or select Undo from the Edit menu.

Under Undo is the Copy button. Copy copies another color to the current color.
When you click this button, the cursor changes to an arrow <--. Now click on the
color you want to copy. If you don't like the change, click Undo. Or select Undo
from the Edit menu.

Use Spread to create a series of gradually changing colors. Spread spreads from
the current color to the color clicked on after Spread is selected. If one of
the colors is black and the other is white, Spread fills the in-between colors
with different shades of gray. Click on the Spread button and the cursor changes
to an arrow <--. Now click on the other color and Spectrum will create the range
for you. Click Undo if you don't like the results.

If you would like to work with the default palette (the one QuickDraw starts up
with), press CTRL-D. This is also useful if somehow the colors get so messed up
that you can't see the cursor.

Non-dithered palettes
If you would like to set up a non-dithered 640 palette, set the first four
colors to what you want and press CTRL-N for Non-dithered palette. This copies
the first four colors into the last twelve.

_____________________________________________________________________________

Appendix D: Dithered Colors
---------------------------
When the eye sees two adjacent pixels in 640 mode, it sees them as one pixel
whose color is the average of the two pixels. For instance, if a black pixel is
next to a white pixel, it will appear to be gray.

Because of this effect, we can fool the eye into thinking we have 16 colors in
640 mode by making one dithered "pixel" out of two alternately colored pixels.

With the default 640 palette, any pixel can be black or white. Even pixels can
also be blue or yellow, and odd pixels can be red or green. So if we alternate
blue and white we see a light blue, or a violet color if we alternate blue-red.

However, when we're drawing with dithered colors, our resolution is actually cut
down to 320 pixels wide, since each dithered "pixel" is made up of two pixels.
The Dither Lock feature makes MiniPaint draw using dithered pixels by drawing
two pixels wide on even pixel boundaries. Turn the Dither Lock on when you want
to make the pencil draw dithered pixels, or make FatBits show dithered pixels,
or when you want to move image with dithered colors.

One problem with dithered pixels is with the paint bucket. A dithered pixel is
actually a pattern made of vertical lines like this: || and if you try to to
fill in between the vertical lines, the next pixel   || is seen as a boundary,
so the only direction it can fill is up or down. Because of this, the bucket
allows you to abort the fill by pressing ESCape. If it seems like it's taking a
while to fill a dithered color, press ESCape. Note: this also affects the lasso.

If you simply want to work with four true colors (non-dithered), use Spectrum to
make a non-dithered palette.


Appendix E: Error messages
--------------------------
Most error message should be self-explanatory, but here's some more information
in case you still have trouble understanding them:

Not enough memory                  IIgs Alzheimer's disease
Can't find the disk                Are you using it as a coaster?
This disk is full                  And refuses to eat another byte
This file is locked                Even the keypad won't help
This disk is write-protected       And we're write-tired by now
I/O Error                          And Matt owes, too

Can't open a new document          Nah nah nah nah nah
Can't put on the scrap pile        We just don't have the heart
Can't paste the clipboard image    Well how about that!
Can't fill                         Regular can't go in an unleaded tank
Can't move this image              It's bigger than Refrigerator Perry
Can't lasso this image             It's much too quick
This can't be undone               Like a few other things in life
Can't save this picture            It's much too ugly
Can't revert                       And we're not even going to try
Can't print                        We're just trying to save your ribbon
Can't load this type of file       And frankly, we don't really care
Can't load this picture            Auto-censoring system functional
Can't get spare page               Not enough memory


Appendix K: Keyboard Shortcuts
------------------------------
To select a tool:

      l  lasso               m  marquee
      h  hand                a  text
      f  bucket              :  spray can
      ,  brush               . pencil
      /  line                e  eraser
      B  hollow box          b  solid box
      R  hollow rounded box  r  solid rounded box
      O  hollow oval         o  solid oval
      Q  hollow region       q  solid region
      P  hollow polygon      p  solid polygon

Previous brush shape:    9                  Fine Tune      t
Next brush shape:        0                  Find Color     k

Previous pen size:       ;                  Invert         n
Next pen size            '                  Flip Horiz     x
                                            Flip Vert      y
Previous color/pattern:  [                  Replace Color  >
Next color/pattern:      ]
                                            Show Page...   keypad =
Turn scroll bar on/off:  s                  Brush Shape... keypad *
Turn info bar on/off:    i                  Pen Mode...    Apple-.
Turn coordinates on/off: c                  Text Mode...   Apple-A
Turn crosshairs on/off:  + or keypad +
Turn Grid on/off:        g

Arrow keys move cursor, Return acts as button.


Appendix M: Pen Modes and Text Modes
------------------------------------
Press Apple-. to choose one of eight QuickDraw pen modes. These modes affect
shapes and lines. If you understand any of this, you're really quite strange.

Copy           copy source to destination (normal mode)
notCopy        copy inverse of source to destination
OR             nondestructively overlay source with destination
notOR          nondestructively overlay inverse of source with destination
XOR            exclusive OR source with destination
notXOR         exclusive OR inverse of source with destination
BIC            bit clear source with destination (erase colored pixels)
notBIC         bit clear inverse of source with destination

Press Apple-a to choose one of eight QuickDraw text modes.

ForeCopy       copies only foreground pixels, not background
notForeCopy    copies only background pixels, not foreground
ForeOR         ORs foreground pixels into destination
notForeOR      ORs background pixels into destination
ForeXOR        XORs foreground pixels into destination
notForeXOR     XORs background pixels into destination
ForeBIC        BICs foreground pixels into the destination
notForeBIC     BICs background pixels into destination


Miscellaneous Drivel and Trivia
===============================
Documentation by Matt Reimer and Randy Brandt (September 14, 1988)

The JEM SOFTWARE logo was designed by David Andersen. The graphics
representation in the MiniPaint "About" window was created by Randy Brandt using
MiniPaint. Fat bits came in REAL handy, as did the coordinates option.

Have you noticed that "Drivel" looks a lot like "Drive 1" without the space?

Matt's Thanx:
-------------
Thanks to Randy for publishing my first "real" disk.

Randy's Thanx:
--------------
Thanks to Matt for letting me publish his first "real" disk.

Thanks to Roger and Tina Wunker for doing all the shipping for JEM Software, and
for often getting the right orders to the right address. :-)

No thanks to Bryan Ross; he made absolutely no contribution to this disk in any
way, shape or form. His antiquated IIc can't even run this software!

Thanks to Lester Simpson for getting a IIgs and for still supporting the Padres
and Chargers even though he left San Diego years ago.


DISCLAIMER OF ALL WARRANTIES AND LIABILITIES
============================================
About ProDOS: This product includes software, ProDOS, licensed from Apple
Computer, Inc. Apple makes no warranties, either express or implied, regarding
the enclosed software package, its merchantability or fitness for any purpose.
Some states do not allow the exclusion or limitation of implied warranties or
liability for incidental or consequential damages, so this limitation or
exclusion may not apply to you.

About MiniPaint: JEM Software's liability is limited to the $22.50 retail price
value of the product (the real value is much higher!). Of course, it's highly
unlikely that you could ever get that out of us unless you return the original
disk with a convincing letter of woe and misery and vowed that you only used 320
mode. After all, we don't have time to test 640 mode.

AppleWorks and ProDOS are registered trademarks of Apple Computer, Inc.
We figure no one would want to steal a name like MiniPaint so we haven't got
around to making it a registered trademark yet.
